home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / dinfavt3.zip / DINFOAVT.DOC < prev    next >
Text File  |  1991-04-02  |  8KB  |  185 lines
  1.  ╒══════════════════════════════════════════════════════════════════════╕
  2.  │  DINFOAVT+ 3.00; RemoteAccess 1.00 ANSI/AVATAR DORINFO?.DEF utility  │
  3.  ╘══════════════════════════════════════════════════════════════════════╛
  4.  
  5.  Dinfoavt.Exe/Dinfoavt.Doc written by geoffrey booher 1:2270/233.0@fidonet.usa
  6.  Copyright (c) 1990, 1991 Gateway Net Technology
  7.  
  8.  disclaimer:
  9.  ───────────
  10.  DINFOAVT+ 3.00 is *ONLY* guaranteed to consume diskspace.  It has been
  11.  extensively tested and found to be pretty reliable.  In no way is the
  12.  Author of this program responsible for any damages, consequential, or
  13.  otherwise from the neglect of DINFOAVT+ 3.00's use or misuse.  DINFOAVT+ 3.00
  14.  is provided as is, without warranty of any kind, either expressed or implied.
  15.  
  16.  DINFOAVT+ 3.00 may be distributed freely subject to the following conditions:
  17.  
  18.  1.  No fees are charged for distributing or obtaining the DINFOAVT files.
  19.  
  20.  2.  The files within the DINFAVT3 archive are not modified in ANY way.
  21.  
  22.  questions:
  23.  ──────────
  24.  Send Netmail to Geoffrey Booher, 1:2270/233.0@fidonet.  Or I suppose any
  25.  questions you have could be addressed to me in the RA_UTIL conference.
  26.  
  27.  
  28.  files in the archive:
  29.  ─────────────────────
  30.  DINFOAVT.EXE - 808X version of the program, this file is ready to use if
  31.                 you have an 808X (XT) based CPU machine.
  32.  
  33.  DIAVT286.EXE - 80X86 version of the program, rename to DINFOAVT.EXE and use
  34.                 this file if you have an 80X86 (286/386/486) based CPU machine.
  35.  
  36.  DINFOAVT.DOC - You're reading it.
  37.  
  38.  WHATSNEW.300 - History and new features in DINFOAVT+ 3.00.
  39.  
  40.  README.1ST   - Notice about the distribution archive.
  41.  
  42.  overview and features:
  43.  ──────────────────────
  44.  DINFOAVT+ 3.00 is a DORINFO?.DEF utility specifically for use with
  45.  RemoteAccess 1.00 and RemoteAccess 1.01.
  46.  
  47.  It's main purpose is to change the DORINFO?.DEF file if the user online has
  48.  BOTH ANSI/AVATAR emulation enabled to plain ANSI so software that does not
  49.  recognise the new 2 and 3 DORINFO?.DEF codes can still do ANSI if possible.
  50.  
  51.  I wrote this program because my users that are taking advantage of my AVATAR
  52.  screens were complaining there was 'no colors' on 'DOORS' and other Type 7
  53.  programs I run.  So ... I figured that these dudes were running the code '3'
  54.  in DORINFO?.DEF that they were using ANSI and AVATAR both.  If that was the
  55.  case, then temporarily change to code '1' ANSI to run the door, and restore
  56.  the  ANSI/AVATAR code '3' after the door.  Simple enough.
  57.  
  58.  
  59.  
  60.                                                                      Page 2
  61.  setting up DINFOAVT+ 3.00:
  62.  ──────────────────────────
  63.  Put the correct Dinfoavt.Exe anywhere in your DOS PATH, along with any of
  64.  your other utilities.
  65.  
  66.  
  67.  DINFOAVT Command line parameters:
  68.  
  69.  DINFOAVT     
  70.  DINFOAVT /?  - shows a help screen.
  71.  
  72.  DINFOAVT /I  - use this switch going INTO the door.  It will look for a
  73.                 DORINFO?.DEF file (yes, it will use DORINFO1, DORINFO2, etc)
  74.                 in the CURRENT DIRECTORY.  If line 10 is '2' or '3', AVATAR or
  75.                 ANSI/AVATAR, it will write a DORINFO?.$$$ file with the
  76.                 original DORINFO?.DEF contents, and change the DORINFO?.DEF
  77.                 file to '1' on line 10 for ANSI if ANSI/AVATAR is detected. It
  78.                 will change the DORINFO?.DEF to '0' if AVATAR alone is detected.
  79.                 If it's 0 - ASCII; 1 - ANSI or 2 - AVATAR only, it won't update
  80.                 the DORINFO?.DEF file, and won't create the DORINFO?.$$$ file.
  81.                 The ASCII/TTY switching was done to insure compatibility with
  82.                 some doors that recognise 2 as ANSI.
  83.  
  84.  DINFOAVT /O  - use this switch on the way OUT the door.  It will look for the
  85.                 DORINFO?.$$$ if it was created by the DINFOAVT /I option.
  86.                 If it doesn't find it, it assumes ANSI/AVATAR both was NOT the
  87.                 initial emulation and will do nothing.  If it finds the
  88.                 DORINFO?.$$$ file, it will overwrite it with the CURRENT
  89.                 DORINFO?.DEF file, and then rewrite a new DORINFO?.DEF file
  90.                 with updated time remaining, etc from the door, and change
  91.                 line 10 back to '3' so ANSI/AVATAR is enabled again upon return
  92.                 to the BBS.
  93.  
  94.  DINFOAVT /IO - this switch just changes DORINFO?.DEF and does not attempt to
  95.                 change DORINFO?.DEF back when the DOOR is done.  Some DOORS
  96.                 use DORINFO1.DEF to get some settings like graphics, but
  97.                 actually use EXITINFO.BBS to update the time used.  This switch
  98.                 is for those types of doors not needing a change afterward.
  99.  
  100.  DINFOAVT /D  - this switch displays the contents of the DORINFO?.DEF file.
  101.  
  102.  using DINFOAVT+ 3.00:
  103.  ─────────────────────
  104.  You will need to create a batchfile to run your door.  Here's an example:
  105.  
  106.  Type 7 - Optional Data: *C /C C:\RA\BBSLIST.BAT *! *M
  107.  
  108.  Bbslist.Bat:                    -OR-
  109.  
  110.  @Echo OFF                       @Echo OFF
  111.  Cd C:\Ra                        Cd C:\Ra
  112.  Dinfoavt /I                     Dinfoavt /IO
  113.  Bbslist Bbslist.Cfg             Bbslist Bbslist.Cfg
  114.  Dinfoavt /O
  115.  
  116.  I realise making batchfiles to run type 7's is not the most elegant way to
  117.  run things, but DINFOAVT+ 3.00 is really a kludge program to give ANSI
  118.  Colors AT LEAST in your doors until such time the doors become AVATAR 'smart'.
  119.  
  120.  
  121.                                                                      Page 3
  122.  DINFOAVT+ 3.00 technical info:
  123.  ──────────────────────────────
  124.  Dinfoavt.Cpp was written in C language with the CPlusPlus extension option.
  125.  Dinfoavt.Exe was compiled with Borland International's Turbo C++ 1.00 using
  126.  the Small Memory Module ( < 64kb heap ).
  127.  
  128.  DINFOAVT.EXE has the following errorlevels:
  129.  
  130.  Errorlevel 4 - invalid parameter or no parameters (help screen)
  131.  Errorlevel 3 - DORINFO?.DEF not changed and no DORINFO?.$$$ written
  132.  Errorlevel 2 - Could not find DORINFO?.DEF file
  133.  Errorlevel 1 - File I/O error
  134.  Errorlevel 0 - DORINFO?.DEF changed/updated successfully
  135.  
  136.  
  137.  NOTE!! DINFOAVT+ 3.00 expects to find ONE DORINFO?.DEF file in the CURRENT
  138.         DIRECTORY!  If you are running a multi-line system, this should not
  139.         pose a problem as the door will likely be executed in that nodes
  140.         directory.  The RemoteAccess documentation states doors must be run
  141.         from their own seperate directories when running multiple copies, so
  142.         DINFOAVT+ 3.00 should find the correct DORINFO?.DEF file in the
  143.         directory currently in.
  144.  
  145.         If the program finds more than ONE DORINFO?.DEF file in the current
  146.         directory it will use the first one it finds, whether valid or not!
  147.  
  148.  
  149.  thanks:
  150.  ───────
  151.  Thanks to the RemoteAccess Beta Duders and Andrew Milner and Phil MacKay
  152.  for the BEST BBS software available anywhere hands down.  :-)
  153.  
  154.  Thanks to Kevin Zimmerman at The Boomtown BBS - 1:2270/868@fidonet for
  155.  sometimes getting 7 versions of a program per day to pre-test out.
  156.  
  157.  Thanks to Bruce Bodger at The Truckstop BBS - 1:170/400@fidonet for helping
  158.  out with beta bashing my stuff.
  159.  
  160.  Thanks to Bob R. at The Anonymous BBS - 1:154/40@fidonet for some good
  161.  suggestions for DINFOAVT 2.00.  :-)
  162.  
  163.  Thanks to Mark Howard at Rivendell TAP/NA - 1:260/340@fidonet for writing
  164.  RAEXIT for RemoteAccess 1.00 EXITINFO.BBS conversion.  It was his program that
  165.  gave me the idea for the display contents (/d) command.
  166.  
  167.  misc:
  168.  ─────
  169.  The following products/examples are the Copyrighted materials of their
  170.  respective named holders:
  171.  
  172.  Turbo C++ 1.00                  Borland International
  173.  
  174.  RemoteAccess                    Continental Software
  175.  
  176.  BBSLIST                         Off The Wall Programming
  177.  
  178.  AVATAR                          George A. Stanislav
  179.  
  180.  DINFOAVT+ 3.00                  Gateway Net Technology
  181.  
  182.  Fidonet                         Tom Jennings
  183.  
  184.  
  185.